package xyz.ssf.cloud.project.system.service;

import xyz.ssf.cloud.common.core.domain.PageResult;
import xyz.ssf.cloud.project.system.domain.SysRole;
import xyz.ssf.cloud.project.system.domain.dto.RoleDTO;
import xyz.ssf.cloud.project.system.domain.dto.RoleQuery;
import xyz.ssf.cloud.project.system.domain.vo.RoleVO;
import xyz.ssf.cloud.project.system.domain.vo.UserRoleVO;

import java.util.List;
import java.util.Set;

/**
 * 角色业务层
 */
public interface SysRoleService {
    
    /**
     * 根据条件分页查询角色列表
     *
     * @param query 查询条件
     * @return 分页结果
     */
    PageResult<RoleVO> selectRoleList(RoleQuery query);
    
    /**
     * 根据用户ID查询角色列表
     *
     * @param userId 用户ID
     * @return 角色列表
     */
    List<SysRole> selectRolesByUserId(Long userId);
    
    /**
     * 查询所有角色
     *
     * @return 角色列表
     */
    List<SysRole> selectRoleAll();
    
    /**
     * 根据用户ID获取角色选择框列表
     *
     * @param userId 用户ID
     * @return 选中角色ID列表
     */
    UserRoleVO getUserRoleList(Long userId);
    
    /**
     * 通过角色ID查询角色
     *
     * @param id 角色ID
     * @return 角色对象信息
     */
    SysRole selectRoleById(Long id);

    /**
     * 校验角色名称是否唯一
     *
     * @param role 角色信息
     * @return 结果
     */
    boolean checkRoleNameUnique(SysRole role);

    /**
     * 校验角色编号是否唯一
     *
     * @param role 角色信息
     * @return 结果
     */
    boolean checkRoleCodeUnique(SysRole role);
    
    /**
     * 新增角色信息
     *
     * @param role 角色信息
     * @return 结果
     */
    int insertRole(SysRole role);
    
    /**
     * 修改角色信息
     *
     * @param role 角色信息
     * @return 结果
     */
    int updateRole(SysRole role);
    
    /**
     * 修改角色状态
     *
     * @param role 角色信息
     * @return 结果
     */
    int updateRoleStatus(SysRole role);
    
    /**
     * 批量删除角色信息
     *
     * @param roleIds 需要删除的角色ID
     * @return 结果
     */
    int deleteRoleByIds(Long[] roleIds);
    
    /**
     * 删除角色信息
     *
     * @param roleId 角色ID
     * @return 结果
     */
    int deleteRoleById(Long roleId);
    
    /**
     * 查询角色关联的菜单ID集合
     *
     * @param id 角色ID
     * @return 菜单ID集合
     */
    List<Long> getRoleMenuList(Long id);
    
    /**
     * 保存角色和菜单关联关系
     *
     * @param id 角色ID
     * @param menuIds 菜单ID集合
     * @return 结果
     */
    int saveRoleMenu(Long id, List<Long> menuIds);
    
    /**
     * 为当前登录用户分配角色
     *
     * @param roleIds 角色ID集合
     * @return 结果
     */
    int assignUserRole(List<Long> roleIds);
} 